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PREFACE 


The purpose of this manual is to provide new users with an 
introduction to Multics use and a workbook that develops detailed 
applications from principles introduced in Part I of the New Users' 
Introduction to Multics (Order No. CH24). The topics covered here 
have been chosen either because they are useful and, with the 
introduction in Part I, comprehensible to the new user or because 
they illustrate fundamental elements of the Multics system. 


The information presented here is a subset of that contained in 
the primary Multics reference document, the Multics Programmers' 
Manual (MPM). The MPM should be used as a reference to Multics once 
the user has become familiar with this introductory guide. The MPM 
consists of thé following individual manuals: 


Reference Guide (Order No. AG91) 
Coumands and Active Functions (Order No. AGQ2) 
Subroutines (Order No. AG93) 
Subsystem Writers' Guide (Order No. AK82) 
Peripheral Input/Output (Order No. AX49) 
Communications Input/Output (Order No. cCC92) 


Throughout this manual, references are made to both the MPM 
Commands and Active Functions manual and the New Users' Introduction 
to Multics Part I. For convenience, these references will be as 
follows: 


MPM Commands 
Part I 


The Multics operating system is referred to in this manual as 
either "Multics" or "the system." The term "computer" refers to the 
hardware on which the operating system resides. 


The information and specifications in this document are subject to change without notice. Consult 
your Honeywell Marketing Representative for product or service availability. 
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SECTION 7 


INTRODUCTION 


MANUAL CONVENTIONS 


Part II of the New Users' Introduction to Multics continues 
the discussion of Multics command language which was begun in 
Part I (CH24). Its purpose is to explain some of the detailed 
uses possible with the basic components of the language--commands 
and arguments--and to equip the user with a wide range of 
features and conventions that make command ianguage extremely 
flexible and easy to use. This is accomplished through sections 
that illustrate detailed command applications, explain the use of 
active functions, and present important command language features 
such as the star convention and exec_com. Also included is a 
section on important computer concepts and their specialized 
application in Multics. Finally, there is a list of additional 
glossary items that supplement those in Part I and that will be 
valuable as you become more fully acquainted with computers and, 
in particular, Multics. 


The conventions and special symbols used in this manual are 
the same as those in Part I. 


Technical or other unfamiliar terms are underlined when used 
the first time and are included in the glossary (Appendix A). 


When a command is referred to for the first time, its short 
name is shown in parentheses immediately following the long name. 
For example, print (pr). 


Examples of lines printed on a terminal use exclamation 
points to indicate lines that the user types. These characters 
will not be typed by the system as a prompt to you, and they are 
not to be typed by you. 
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The ready message used in examples is the regular message 
printed by the system: 


e 19202--1 4425: 71 


The first set of numbers tells the time of day on the 24-hour 
clock. The 13:02 indicates it is two minutes after one o'clock 
in the afternoon. The second set of numbers shows the amount of 
CPU time you've used since the last ready message, and the third 
number (77 here) indicates the number of pages of information 
brought into main memory from secondary storage since the last 
ready message. (See below for a discussion of CPU, memory and 
storage.) 7 


But before we embark on this further discussion of Multics 
software, it may be interesting to you to understand the 
fundamental operation of computer hardware. Hardware is a term 
used to refer to the physical units that make up a computer 
system, the apparatus as opposed to the programs. Multics itself 
is not a computer; it is a software system, a system of 
sophisticated programs. As we shall see in the following 
discussion, there are a number of machines that comprise the 
hardware system that the Multics software runs on. 


PERIPHERALS 


Peripherals are machines that can be operated under computer 
control but do not perform the control and computational 
functions of the central computer. Terminals are peripheral 
devices with which you are probably already familiar. Others 
include keypunch machines and card readers, line printers, and 
storage devices such as magnetic tapes and disks. 


Terminals 


There are basically two types of terminals: printing or 
hardcopy terminals and video terminals, commonly called CRTs 
(cathode ray tube). Both have keyboards that resemble those on 
typewriters, and both accept output as well as input. The video 
screen showS your input and output on a television-like screen 
whereas hardcopy terminals print input and output on paper as you 
work and thereby provide immediately a printed record of your 
terminal session. 


Card Readers 
Card readers transfer programs and data punched on computer 
ecards to the central computer. <A necessary accompanying device 


is the keypunch, a typewriter-like machine with which you type 
characters onto computer cards. 
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Storage Devices 


On most systems, storage consists of two parts~-main memory 
and secondary storage. When information in secondary storage is 
to be processed, it is brought into main memory where it can be 
manipulated more rapidly. On the Multics system, however, all 
information can be processed at the same high speed, so there is 
no essential difference between main memory and secondary 
storage. This is the special Multics feature called virtual 
memory, which is discussed in Section 7. 


The principal device used for storage in the Multics system 
is the disk; all information stored in the virtual memory system 
is on disks. Information can be stored on tapes and cards in the 
Multics system, but when it is, it is not part of the virtual 
memory system. A special connection must be made in order to 
process that information. 


Line Printers 


Line printers are so called because they print out results 
from a computer one line ata time. Unlike terminals, line 
printers are strictly output devices; they do not accept input. 
Line printers do, however, print output at very high speeds, much 
faster than terminals. 


CENTRAL PROCESSING UNIT (CPU) 


The central processing unit is the nerve center of the 
computer system; it coordinates and controls the activities of 
all the other units and performs all the arithmetic and logical 
processes to be applied to data. We can consider it as being 
divided into three functional parts: 


4 an appending unit (APU) 

os a control unit 

5% computation units 

The appending unit iocates information in memory and cnecks 
the access that the particular user has to the information. 


Multics software uses the APU to provide the unique level of 
security that protects information kept on the system. 


The control unit acts as a synchronizer. It interprets 
instructions sent to it by the APU and issues the appropriate 
commands to the computation units. 
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There are two units in the CPU that perform computations: 
the operations unit and the decimal unit. Between them these two 
units perform basic computations such as addition, subtraction, 
division and comparison. 


INPUT/OUTPUT MULTIPLEXER (IOM) 

The input/output multiplexer processes information coming 
from terminals, card readers, and some parts of storage and 
returning to terminals or going to line printers. On some 
systems, a similar mechanism is called the input/output processor 
and sometimes it even resides within the CPU. 


FRONT-END NETWORK PROCESSOR (FNP) 

The front-end network processor is the piece of hardware 
incorporated into some systems to process information coming into 
and going out of the system by way of communication channels 
(e.g., telephone lines). Thus all input from terminals, and 
output directed to terminals, goes through the FNP because the 
terminals are all connected to the computer by one type of 
communication channel or another. Card readers, on the other 
hand, do not necessarily send their input through the FNP; they 
do so only if they are connected to the computer by way of 
communication channels, as is the case when they are ata 
different site than the computer. The FNP must be at the same 
Site as the central computer. 


With the description of major hardware items now complete, 
we can construct an illustration of how the hardware used by the 
Multics system is interconnected: 
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Figure 1-1. Components of Multics Hardware 
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COMPUTER LANGUAGES 


The CPU and front-end processor operate according to a coded 
language that is very intricate and hard for humans to use 
efficiently. When we put information into the computer, we use 
coded languages that are easy for us to understand. These 
languages are usually called higher level languages. Some that 
you've probably heard of already are FORTRAN, PL/I, and COBOL. 
But these languages must be translated into the machine's 
language before the computer can perform its work. A compiler is 
the thing that translates a higher level language into machine 
language. 


The compiler is not a hardware item in the computer system; 
it is a program. It resides in storage and can be called when 
needed. As a matter of fact, there are usually several compilers 
with each computer because each higher level language has its own 
program to translate it into the machine's code. On the Multics 
system there are compilers for FORTRAN, PL/I, COBOL, BASIC, and 
APL. | 


There is also another . translating program similar toa 
compiler called an assembler. It too translates a programming 
language into machine code. But instead of translating a higher 
level language like COBOL, it translates a programming language 
called assembly, a language whose code is a symbolic form of 
machine language that resembles English much less’ than higher 
level languages do. 


But the commands, active functions, texts, etc. that you 
enter at a terminal are not written in either higher level 
languages or assembly language. Instead, you are typing in a 
language (much of it specific to Multics) that calls or activates 
programs that are already written and reside in the system. On 
Multies, these programs are written in PL/I, and, indeed, these 
programs are the system, the Multics software system. What you 
type ata terminal calls programs and supplies data for their 
running, and it is to this procedure that we will now turn our 
attention for the remainder of this manual. 


WOH PAA ” nae 
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SECTION 2 


MULTICS COMMAND LANGUAGE 


A command is, as the name implies, a directive that you the user 
give the Multics system to make the system perform some action. You 
issue a command by typing its name at the terminal, along with 
arguments and control arguments, and concluding with a newline, a 
combination of a carriage return and linefeed. This sends the 
particular command message, or command invocation, to the command 
processor where it is evaluated and acted upon. If in evaluation the 
command processor finds that the line is improperly typed (which, in 
most cases, means misspelled), or if the command program finds that 
the line is incorrectly structured with arguments and control 
arguments, an error message is returned, indicating where the mistake 
is: 


! primt report 
segment primt not found. 


r Os 5 21aad 55 


print 3 12 report 
print: Entry not found. >user_ dir dir>Pubs>Smith>3 
PuGs37 sae 55 


The command processor return the error message in the first 
example because it cannot locate a command with the misspelled name. 
In the second example, the command processor can find the command 
named "print," but the command program cannot find a segment whose 
pathname is "3." Thus the command cannot execute and so returns the 
error message. The print command will print part of a segment when 
line numbers are specified (e.g., 312); but in this case, the line 
designation comes incorrectly before the pathname of the segment to 
be printed. The correct syntax is: 


! print report 3 12 
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When the processor and the command program find that all is well 
with the command invocation (which, by the way, is referred to simply 
as a command line throughout most of Multics documentation), then the 
command is executed. Finding that the invocation is correct means 
that the command processor was able to locate a program referred to 
by the command name given and that the command is capable of running 
on the arguments and control arguments given. 


SYSTEM AND USER-WRITTEN COMMANDS 


Most command programs in Multics are available throughout the 
entire system and can be executed by any user. There are, though, 
a few commands that can be used only by the system administrator, 
commands that control system usage, such as those needed to put new 
users on the system. 


Then too, you the user can write special commands, normally 
called user-written commands, that can be executed in the same manner 
as system commands, though only by the user who creates them and anyone 
given access to them. 


COMMANDS APPLIED 


There is quite a large number of commands on the Multics system 
and these commands can be applied to a variety of situations. Most 
commands are adapted to particular situations by using arguments and 
control arguments, as is discussed in Part I of the New Users' 
Introduction. Some commands can operate by themselves, that is, 
without any arguments specified by the user. Commands of this type 
may not accept arguments, such as the command that prints the current 
working directory (print wdir), or they may operate with certain 
preestablished arguments, default arguments, unless the user 
specifies otherwise. A good example of the latter is the help command 
discussed in Part Il. Invoked without any control arguments, the help 
command prints information explaining how to use the help command. 
Then of course with the name of an info segment given as an argument, 
the help command will print the explanation contained in that info 
segment. 


Another such command is list (1s), and it serves as a good example 
of how a command can be adapted to particular situations. When 
invoked without any pathname or control arguments, the list command 
prints the names of all segments in your working directory. For 
example: 
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Smith.profile 
work.list 
work 

print.ec 
output file 
data_base 


O—->HFMAWWO © 


If, however, you only need to know how many segments exist in 
your working directory and how long they are, you can specify that 
the command return just the total shown in the heading by using the 
control argument -total (-tt): 


rf ls =tt 


Segments = 8, Lengths 


You can make this command return even more specific 
information by adding the pathname of a particular segment. You 
could, for instance, check the length of a particular segment by 


typing: 


f ls Smith.profile 


a 


Segments = 1, Lengths = i. 


1 Smith.profile 


segment. Suppose that the segment is known by several different names 
and you want to know only the names of the segment. By adding the 
-name control argument, youcan get a list of the heading and the names 


without the access listing: 
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! is Smith.profile -name 


Segments = 1, Lengths 


Smith.profile 
John 
prof 


Using this control argument can save processing time when you are 
listing names of a lot of segments, as you can do quite easily with 
the star convention discussed in Section 4. 


In yet another case, you could check the last time the segment 
was altered by adding the date time contents modified control 
argument (-dtem): 


! is Smith.profile -name -—dtcm 
Segments = 1, Lengths 
07/05/79 1456.3 Smith.profile 


John 
prot 


The time of day is represented here in terms of the 24-hour clock; 
1456.3 is 2:56 p.m. Knowing when a segment was last changed can be 
helpful in a variety of ways, such as keeping track of updates to the 
segment. 


In most cases, especially when checking a specific segment, you 
don't need the header information, so that can be eliminated by typing 
is another control argument: 


! 1s Smith.profile -name -dtcm -no_header 


07/05/79 1456.3 Smith.profile 
John 
prof 


Control arguments give you a great of deal control over how 
comments execute. Normally control arguments follow pathname 
arguments on the command line, though most commands don't require that 
you arrange the control arguments in any particular order. For 
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instance, the three control arguments in the above command lire could 
be arranged in any order after the pathname. And as is demonstrated 
below, control arguments can themselves take arguments that further 


mre. Pew 


specify how a particular command is to execute. 


MULTIPLE COMMANDS 


Sometimes it is easier to send several commands to the command 
processor at one time rather than send them separately. To do this 
you Simply place a semicolon at the end of each command, after its 
arguments: 


! print_messages; print wdir; who; help sked 


Note: There is no need to type a semicolon after the last 
command and its arguments 


If you were to send the commands separately, as we've been doing 
in examples up to this point, you would have to wait for the command 
to process and for another ready message to be printed before typing 
the next command line: 


r 10251 02662 07 


print messages 


r 10:32 0.062 0 


i sprint wdir 


r 10:34 0.557 17 


291 Os 900 17 


Note: The three dots between commands and ready messages are 
meant to represent the output from the commands. 
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But none of the four commands in this example require that you wait 
for the others to process; for instance, you needn't see the results 
of the print messages command before typing the print wdir command. 
So you can send them all to the command processor at the same 
time. 


This technique is also useful when you are invoking commands that 
don't return information to your terminal. For example, when you 
change working directories, there is no reason why you couldn't send 
the next command to the command processor right away: 


! change wdir >udd>Pubs>Jones; print seg 2 


It would be slower to type the commands on separate lines because 
you'd have to wait for another ready message before typing the second 
command. By putting both commands on the same line you will be ready, 
when the next ready message appears, to proceed with what you've 
learned by reading the contents of seg 2. 


RESERVED CHARACTERS AND QUOTED STRINGS 


The Multics command language reserves some characters to which 
special significance is attached. The reserved characters are: 
space, quotation mark ("), semicolon (;), the newline character, the 
vertical bar (|), parentheses, and brackets ([]). Earlier in this 
section we discussed special meanings of the semicolon and 
newline character. Here wewill cover some special uses for the blank 
space and the quotation mark, and you will see the special 
Significance of parentheses when we discuss iteration below. The 
special uses of brackets and the vertical bar are discussed in Section 
3. 


~ 


The space character is reserved for separating arguments, 
including command names, on the command line. For that reason 
character strings cannot contain blank spaces and instead simulate 
blanks with the underscore character, as is discussed in Section 3 
of Part I. 


Quotation marks are reserved for passing other reserved 
characters to the command processor without the meaning that is 
normally attached to them. 
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To illustrate this usage, let's look at an instance in which a 
Space is used to separate two elements in a command line that are not 
separate arguments. For this example we will use the sort list 
command, a rather uncomplicated command (fully described in the 
Multics WORDPRO Reference Guide, Order No. AZ98) which you may 
actually come to use quite often. The command's syntax is: 


sort list pathname -sort STR 


The pathname is that of a segment which is designed specifically to 
hold lists, and the -sort control argument indicates how the segment 
is to be sorted. It does that by using, in the argument position 
marked by STR, one or more of the names that differentiate elements 
within the list, such as "lastname" and "firstname." 


Now, assume that you have a segment in your directory that 
contains a list of customers' names and you want to sort that list 
by last name and first name. For instance, if you had both John Doe 
and Jane Doe in your list, you would want Jane placed before John in 
the alphabetically sorted list. In this case you must include both 
"lastname" and "firstname" in the argument to the -sort control 
argument. So, you might type: 


! sort list customers -sort lastname firstname 


where "customers" is the pathname of the segment containing your list 
of customers. 


But this invocation would return the error message: 


sort list: Specified control argument is not implemented by 
this command. firstname 


because you are using a space between "lastname" and "firstname." 
Since the character string following the control argument is an 
argument in its own right, the space between "~sort" and "lastname" 
operates legitimately to separate the two. And when the command 
processor encounters the space between "lastname" and "firstname," 
it interprets "firstname" to be another argument. But the -sort 
control argument, takes only one argument, so the presence of what 
appears to be a second causes an error message to be returned. 


In order to suppress the normal meaning of the space character 
here, and thereby make the two separate character strings appear as 
one argument, you must enclose the argument to the control argument 
in quotation marks: 


! sort _list customers -sort "lastname firstname" 
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ITERATION 


Iteration is one of several methods Multics provides for 
economizing typing of the command line. By enclosing elements of a 
command line in parentheses, you can have each of the elements 
processed separately. This enables a user to change one or more of 
the elements used in processing a command. For instance, if you 
wanted to print three segments with the print command you might 


type: 
! print seg 1; print seg 2; print seg_3 


But with iteration you could simply type the command once and then 
enclose the three segment pathnames in parentheses: 


! print (seg_1 seg 2 seg 3) 
Parentheses used in this fashion on Multics indicate that the 
individual items separated by blank spaces within the parentheses are 
to be processed separately by the command. With the command line used 


here, the segments would be printed one after another, starting at 
the left. 


Iteration can also be used with command names. If you wish to 
invoke two commands on the same segment, you would type: 
! (print delete) seg 1 
In effect, this command line is: 


! print seg 1; delete seg 1 


Alse, more than one iteration can be invoked with a command. In 
such a case, each element from one iterated set is processed with a 
corresponding element from another set. For example: 


! rename >Smith dir>(Jones Brown Doe) (Day White Green) 
expands into: 
rename >Smith dir>Jones Day 


rename >Smith_dir>Brown White 
rename >Smith_dir>Doe Green 
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Iterated sets may also be nested, that is, placed one with the 
other. This practice is particularly useful when subsets of an 
element are repeated. Parentheses are evaluated from left to 
right. For example: 


! create dir >Smith dir>(new>(first second) old>third) 
creates three directories: 


>Smith_dironew>first 
>Smith dir>new>second 
>Smith dir>old>third 


The directory names "first" and "second" are nested within the 
iteration composed of the two elements "new" and "old>third." The 
directory name "new" is added to ">Smith dir>" first along with one 
of the elements from the nested iteration--"first." Since there is 
a nested iteration attached to "new," it is called a second time with 
the other element from the nested iteration--"second." Then the 
second element in the outer iteration--"old>third"--is added to the 
directory name ">Smith dir>." 


It is important to note here that there must be a blank space 
between separate elements in an iteration (e.g., "first" and 
"second") because they are separate arguments on the command 
line. 


We have now developed some fairiy detailed command 
techniques that demonstrate how precise Multics commands can be when 
applied with arguments and control arguments. In subsequent sections 
we will look at still more ways of specifying the manner in which 
Multics commands are to be run. 
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SECTION 3 


ACTIVE FUNCTIONS 


An active function iS a program that provides current 
information such as the date, name of the day, and name of your last 
message sender. Some of the information supplied by active functions 
can be supplied by commands, and in fact many active functions can 
act as commands, just aS some commands can serve as active 
functions. But the principal service of an active function is to 
place current information in a command line that is then executed with 
that information as a part of the command's program. When active 
functions are typed in a command line, their programs are executed 
first and the results of those programs returned to the command line 
to be processed with the command. It is in this way that you can make 
many standard Multics commands conditional; that is, the results of 
the invocation of the complete command line depend upon the 
information received from the active function. 


To see the results of an active function you can type some on 
a terminal as commands. Not all active functions can be typed as 
commands (those that can are listed in the MPM Commands), but the two 
that follow are used to demonstrate what results from the invocation 
of an active function. The first example Shows an active function 
which returns information by itself, that is, without using a 
pathname: 


! date time 


08/09/79 1130.2 est Wed 


The second example uses an active function which requires a pathname 
argument for its operation: 


! contents seg 1 


On a clear day you can see forever. 
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ACTIVE FUNCTIONS AS SUBSTRINGS 


When an active function is used as an argument in a command 
line, the normal usage, it must be surrounded by brackets. The 
simplest form is: 


[af arg1... argN] 


where af is the name of an active function and argi represents the 
character string arguments to the active function. (Throughout 
Multics documentation, syntax lines that explain the structure of 
command lines containing a variable number of arguments use argument 
1 (arg1) through argument N (argN), the N representing the number of 
the last argument used. Collectively, these arguments are referred 
to as argi.) 


In the following example, an active function is included in a 
command line: 


! send message [last_message sender] Thanks for the link. 


When you type a newline and send this message to the command 
processor, the last message sender program is executed and the 
resulting value returned to the command line, in this case a 
User_id. The resulting value is not printed on the terminal, nor is 
the command line reprinted, but if it were it would look like 
this: 


send message JDoe.Pubs Thanks for the link. 


That of course is just what would appear if you took the time to 
type the last message sender's User id. 


More than one active function can be used in a single command 
line. Suppose, for instance, that, wishing to keep track of the time 
you spend on individual jobs, you record the time at which you begin 
each job by sending yourself a message like the following: 


! send message [user name].[user project] Mailing list started at 
[date time] 


This command line uses the active function "user," which requires an 
argument (see the description of this active function in the MPM 
Commands). Here your Person _id and Project_id would be returned to 
the command line along with the date and time that you typed the 
message and it could all be saved in your mailbox as a message: 


From Smith.Pubs 11/12/79 1200.7 est Mon: 
Mailing list started at 11/12/79 1200.7 est Mon 
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Nesting Active Functions 


Active functions can also be nested in acommand line, that is, 
one function included within another. For instance, if you wish to 
underline the contents of a segment and have it printed on your 
terminal, you would use the string active function as a command and 
type: 


! string [underline [contents seg 1]] 


Of course, all executions within the brackets will be processed before 
the string command is processed. Each time the command processor 
encounters a right bracket (]) it returns to the matching left bracket 
({) and evaluates the enclosed active function. This means that the 
innermost active function is evaluated first. To execute the above 
line, the command processor first evaluates [contents seg 1] and 
returns, for example: - 


On a clear day you can see forever. 
Then the command processor evaluates the next element: 
[underline On a clear day you can see forever.] 


and returns: 


The string command then operates on this string by printing it out 
on the terminal. 


The term "active string" is often used interchangeably in 
Multics documentation with the term"active function." Actually, it 
refers to the entire string of characters enclosed within a single 
set of brackets, and this could include several separate active 
functions. Nesting, as we've just seen, is one way of including more 
than one active function within a set of brackets. Another way is 
to separate active functions with semicolons, as in the 
following: 


! string [plus 3 4; times 5 6] 
Here the active function string is used as a command on the active 
functions plus and times. The two active functions in this active 
string are processed separately and returned as arguments to the 
command. After the results of these two active functions have been 
returned, the command line is: 


String 7 30 
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Since string used as a command simply prints the arguments that follow 
it, the printed result of this command line is: 


{ 30 


Iteration of Active Functions 
Active functions can also be used with iteration. (See 
Section 2 in this manual for a full description of iteration.) For 
example, if a segment named "all" contains the name of three segments, 
seg _ 1, seg 2, seg 3, then the command line: 
! string [contents all] 
will print the names returned by the active function contents: 


seg 1 seg 2 seg 3 


If, on the other hand, the active function was also included in 
parentheses: 


! string ({contents all]) 


then the command would print the names of each of the three 
segments vertically: 


seg 1 
seg 2 
seg_ 3 


because the active function returns the three names within the 
parentheses so the command processed is: 


string (seg 1 seg 2 seg 3) 


In effect, the string command is being invoked three times in this 
command line, as if the line were: 


string seg 1; string seg 2; string seg 3 
Iteration can also be used within an active string, as in the 
following: 
! string [(plus times) 2 3] 
Here the two active functions are processed separately, each one using 
the arguments 2 and 3. Both active functions are processed before 


the command executes, so the command line becomes, in effect: 


string [plus 2 3] [times 2 3] 
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This then becomes: 
string 5 6 


and the command execution causes the following line to be 
printed: 


5 6 


Rescanning 


After an active string has been evaluated, the return value is 
rescanned for additional active strings before being inserted into 
the command line; the command processor continues scanning until all 
pairs of brackets have been evaluated. For example, if seg 4 contains 
just one line consisting of the string ([Lcontents all]) described 
above, then the command line: 


! string [contents seg 4] 
invokes ([Lcontents all]) as an active function which returns seg 1 
seg 2 seg 3, the contents of the segment named "all," enclosed in 
parentheses so that the command is executed as: 
string (seg 1 seg 2 seg 3) 
or: 
string seg 1; string seg 2; string seg 3 
This rescanning can be stopped by placing a double vertical bar 
(11) before the active function. If, for instance, you want to print 
the contents of a segment which contains right and left brackets and 
not have those brackets interpreted as another active function, you 
would use the double vertical bar as it is used in the following 
command line: 
! string j;;lcontents seg 5] 
With this notation the entire returned value would go to the command 
processor without being checked again for brackets. Assume that the 


contents of seg 5 are: 


Now [time of crisis] is the time for all good men to come to the 
aid of their country. 
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Without the double vertical bar, this returned value would be 
rescanned. The word "time" would be read as a valid active 
function, but since "of crisis" is not a valid argument for this 
function, an error message would be printed onthe terminal. But with 
the double vertical bar in front of the original active function 
brackets, as in the above command, the string command will simply 
print out the above segment, including the brackets and enclosed 
phrase. 


There also may be times when you wish to rescan a returned value 
for some reserved characters (see Section 2in this manual for alist 
of reserved characters) but not for brackets. In those cases, a 
single vertical bar (}) will cause a returned value to be rescanned 
only for quotation marks. For example, consider the command 
line: 


! string [contents seg 6] 
where the contents of seg 6 are: 
The symbol ] will be used to mark the end of each category. 


After the first scanning of this command line, the returned value 
would be included in the line as: 


string The symbol ] will be used to mark the end of each 
category. 


Since the rescanning procedure continues until all brackets have been 
dealt with, this line would be rescanned and an error message returned 
because there is no left bracket to match the right one. 


But if the command line included a single vertical bar before 
the active function: 
! string |[contents seg 6] 
then the returned sentence would not be rescanned for reserved 
characters such as brackets. The command would be sent to the command 


processor and the sentence, with the right bracket included, would 
then be printed. 
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ACTIVE FUNCTION ERRORS 


If the command processor detects an invalid input argument or 
some other error in an active function that prevents it from returning 
the expected value, it signals the active function error 
condition. The standard system action for active function error is 
to print a message describing the error that was found and create a 
new command level. For example, in the following command line, 
arguments that designate segments have not been included with the 
contents active function, so an error message has been returned saying 
why the active function cannot be processed: 


string [underline [contents]] 
contents: Wrong number of arguments supplied 


Error: Bad call to active function contents 
r 14:03 0.090 76 level 2 


You will note here that the command level is now level 2. 
Whenever another command level is created, the bad command line is 
held and you are shifted to a new command level. For this reason you 
should type: 


! release 


in order to release the bad command or commands and return to the 
original level. Then you can correct the error and retype the command 
line. 


Not all errors made with active functions signal the 
active function error condition. For instance, if you do not match 
brackets properly, you will get an error message, but you will not 
be placed to another command level: 


! string [underline contents seg 1]] 


command processor : Brackets do not balance. 


r 14:04 0.034 50 


Since the command processor has returned you to the original command 


level, you need not type release. You need only type the corrected 
command. 
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SECTION 4 


IMPORTANT COMMAND LANGUAGE FEATURES 


Several features of Multics enable you to apply commands to a 
wide range of segments simultaneously. Thus far we have concentrated 
on the flexibility with which you can invoke single commands with a 
limited number of pathnames. In this section we will see how Multics 
command language enables you to multiply both the commands and the 
pathnames executed by issuing one command line. It is with these 
features that you gaintruly efficient control over the large quantity 
of information that Multics allows you to store. 


STAR NAMES 


A detailed command like the one constructed in Section 2can also 
be applied with precision another way=--across a wide range of 
specified pathnames. One way to do this is by using the star and 
equals conventions. Many commands that accept pathnames as input 
allow any component of the final entryname in the path to be a 
star. This star (*) then represents all names that appear in that 
position of the pathname, and thus the command will operate on arange 
of pathnames rather than on just one. 


The list command will serve well to illustrate this feature. 
Suppose you store in your working directory a number of segments 
whose entrynames have "plans" as their last component. With these 
you keep track of all your plans and changes you make in them. To 
list them all without using the star convention would require you to 
type each pathname in full: 


4—] CH25-00 


ls seg 1.plans seg 2.plans new.plans rev.plans old.plans 


Segments = 5, Lengths = 


seg 1.plans 
seg 2.plans 
new.plans 
rev.plans 
old.plans 


With the star convention, you can get all of these segments listed 
with a much shorter command line: 


! ls *.plans 
Use of this single asterisk can be expanded to fit a variety of 


Situations like the following (the -no header control argument is 
used to eliminate the list header from these examples): 


! ls seg_1.*.* -no_header 


seg 1.new.plans 
2 seg 1.old.plans 


The above sample execution lists all segments with entrynames 
composed of three components, the first being "seg 1." 


! ils *.plans -no header 


1 add.plans 
1 seg 1.plans 


The example above lists all segments whose entryname has two 
components, the second (and last) being "plans." 


-no header 


seg 1.new.names 


seg 1.0old.plans 
add. new.plans 
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The above example lists all segments with three-component 
entrynames. 


Sometimes occasions arisé when you wisn to specify part of a 
component as variable rather than the whole component. Multics 
provides for this with the question mark (?) feature of the star 
convention. The question mark represents just one letter of an 
entryname. Suppose, for instance, that you wish to list all pathnames 
consisting of one three-letter component. 


! 1s ??? -no header 


Suppose then that you want to list all segments in your working 
directory with two-component entrynames, the second containing the 
word "plans" followed by exactly one character. In this case you 
would use a question mark and a star name: 


f ils *.plans? -no header 


rw 2 seg _1.planse 
row 1 seg _1.plansi 
rw 1 add.plans1 i 


These two features can even be used together in the same 
component of anentryname. In the following example the command will 
list all segments with one-component entrynames beginning with "ad" 
and containing at least three characters: 


! 1s ad?* -no header 


rw 1. add 


| rew 2 additional | 
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In this case the question mark and star are used together because the 
user wants listed only segments whose entrynames have at least three 
characters. The question mark cannot be interpreted as null, that 
is, having no corresponding character, so only entrynames with at 
least one character after "ad" are listed. But the star can be 
interpreted as null when it is used to represent part of a component, 
so entrynames with no more than one character after "ad" are listed 
(e.g., "add"), So too, the above command used without the 
question mark would list two-character entrynames as well as 
those with three or more characters: 


ls ad* -no header 


r ow 1 add 
rew 2 additional 
rew 1 ad 


Yet another feature of the star convention is the double star 
(*#*) which matches any number of components (including none) in the 
corresponding position in the entryname. For instance, the following 
command line will list all entries in the working directory which have 
"plans" for the last entryname component. 


is **,plans -no header 


seg 1.plans 
add.plans 

seg _1.old.plans 
plans 


Notice that this form of the pathname argument will also return an 
entry whose only component is "plans"; that's because the double 
star can be interpreted as null. In order to get only "plans" entries 
with two or more components, you would type: 


ls *.**®, plans -no_ header 


seg 1.plans 


add.plans 
seg_1.old.plans 

add. new.plans 

seg 1.old.test.plans 
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The single star is added here because it is not interpreted as 
null when it is used torepresent an entire component. Thus, the star 
name in this command line returns only entrynames with at least two 
components. The single star can be interpreted as null only when it 
represents part of an entryname component (e.g., "ad*"), not when it 
represents an entire component. 


The double star, on the other hand, can be interpreted as null 
whenever it is used, though of course there would be no reason to use 
it for representing anything but one or more complete entryname 
components. 


EQUAL NAMES 


Some commands that accept pairs of pathnames as their 
arguments (e.g., the rename command described in the MPM 
Commands) allow any component of the second entryname to be an equal 
sign. This equal sign (=) then represents the corresponding 
component of the first entryname given after the command name. For 
instance, if a segment named random.data is to be renamed 
ordered.data, the user would type: 


rename random.data ordered.= 

The convenience of this is more significant when several 
entrynames are being typed. For example, in the following add name 
command: 

add name world.data =.statistics =.census 
is equivalent to: 

add name worid.data world.statistics worid.census 

The equal name convention (commonly referred to in Multics 
documentation as the equals convention) becomes extremely useful for 
matching series of entryname components when it is combined with the 
star convention. In the following command, all two-component 
entrynames with data base as their second component are renamed with 
data as their second component: 

rename *.data_ base =.data 
The combination of star with equal name can be extended, as in this 
case, for example, where you wish to rename all segments whose 
entrynames have "plans" as their last component. The command: 

rename *.plans old =.= 
will append "old " to each first component of the following 


entrynames: 
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program.plans 


add.plans 
seg _1.plans 


On the other hand, the above command would not change the following 
segment names: 


1.program.plans 
new.add.plans 


my.seg 1.plans 


because the star name path "*,plans" returns only segments with 
two-component entrynames whose second component is "plans." 


Another equal name feature that iS comparable to a star name 
feature is the double equal sign. Like the double star, the double 
equal represents more than cone entryname component, as in the 
following command: 


rename one.two.three 1.== 
which is equivalent to: 
rename one.two.three 1.two.three 
In this example the double equal sign stands for all components 


following the first component, in this case two components, "two" and 
"Chree," 


In the example that follows, the entryname using an equal name 
contains more components than the matching entryname. Thus the 
double equal sign does not correspond to any components of the 
matching entryname and it is ignored. The commands: 


rename alpha.beta == 


rename alpha.beta x. 
rename alpha.beta x. 
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are equivalent to: 
rename alpha.beta x.y 


Like the double star, the double equal sign can be interpreted as null. 
In this example, only the specified components of the matching 
entrynames, "x" and "y", are used because two are enough to match the 
initial entryname, "alpha.beta." 


There is a difference between the way single and double equal 
Signs are interpreted when they have no corresponding component. 
When a single equal sign appears in a position where no corresponding 
entryname component exists, Multics responds with an error message, 
such as in the following: 


rename aipha beta.=.gamma 


rename: Illegal use of equals convention, 
beta.=.gamma for alpha 


Unlike the double equal sign, the single equal sign cannot be 
interpreted as null. This usage is, tnerefore, illegal because there 
is no second component in the entryname "alpha" with which to match 
the equal name component. But with a double equal sign the command 
would function because this sign can represent any number of 
components, including none, as is the case in the three examples above 
where "alpha. beta" is renamed "x.y." 


Finally there is the triple equal sign feature of the equals 
convention. The triple equal sign component represents all 
components of the corresponding entryname and thus no other component 
of the equal name may contain an equal sign. The triple equal sign 
is used to add components to a name, as in the following: 


rename test.plans ===.old 


which is equivalent to: 


rename test.plans test.plans.old 


There is one last aspect of the equals convention to discuss, 
though you may not use it very often. It is the percent sign (4%), 
and it is similar to the question mark in the star convention. The 
percent sign (%) represents a single character ina specific position 
in the corresponding entryname component. For instance, the 
command: 


rename ???*.,data %4%4%.= 
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renames all two-component entrynames that have a last component of 
data and a first component containing three or more characters so that 
the first component is truncated to the first three characters and 
the second component is data (e.g., alpha.data would be renamed 
alp.data). 


CONCATENATION 


Yet another feature of  Multics command language is 
concatenation, the practice of joining separate character strings 
together to form one string. When a character string bounded by 
reserved characters (often called a delimited element) is placed next 
to a string or another delimited element in a command line, the two 
are concatenated. You can thus form character’ strings by 
concatenating elements such as parenthetical expressions, active 
functions, and quoted strings. If, for instance, while working in 
another directory you wish to rename a segment in your home 
directory, you could concatenate the home dir active function with 
the pathname arguments of the rename command to economically invoke 
the command: 


rename [home dir]>seg 1 seg _1.o0ld 


The home dir active function would return the character string name 
of your home directory (e.g., >udd>Pubs>Smith). The command line 
shown here would thus change: 


>udd>Pubs>Smith>seg 1 
to: 


>udd>Pubs>Smith>seg 1.old 


HOW COMMANDS CAN BE INTERRUPTED 

Often it is desirable to interrupt a command before its execution 
is complete. You may discover while the command is executing that 
amistake has been made, or it may simply not be necessary to execute 
the command entirely. For example, you may issue the print command 
but not need to see the entire segment printed. So as soon as the 
needed information is printed, you could issue a quit signal. The 
quit signal's key varies from terminal to terminal; it may be either 
BREAK, BRK, INTERRUPT, INTRPT, or ATTN. The quit signal causes 
Multics to stop whatever it is doing and instead print QUIT and aready 
message. 


The ready message printed after a quit signal is slightly 
different from other ready messages because it contains additional 
information after the standard numbers: 


r 9:38 1.123 62 level 2 
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The character string "level 2" indicates that a new command level has 
been established and the interrupted work is being held on the 
previous level. Since the system is at command level, that is, ready 
to accept more commands, you can either continue the interrupted work 
or go on to something else. 


If the work interrupted by the quit signal is to be 
continued, you can issue either the start (sr) or the 
program interrupt (pi) command. The start command resumes execution 
of the interrupted command from the point of interruption, and the 
program interrupt command resumes execution of the original command 
from a known, predetermined reentry point. Usually the 
program interrupt command is invoked when you are working in a 
subsystem like qedx or read mail and you want to interrupt printing 
and remain in the subsystem. This method of resuming an interrupted 
command is useful for skipping over information not needed at the 
time. After the QUIT message is printed, typing the 
program interrupt command will return you to request level. 


If, on the other hand, you do not wish to continue the interrupted 
work, the interrupted command should be released before any other 
commands are issued. It is expensive to hold interrupted commands 
at a command level. The release command (rl) releases the work 
interrupted and neia by the quit signal and returns the system to the 
previous command level (and drops the level information from the ready 
message). 
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ABBREVIATION AND ARGUMENT SUBSTITUTION 


There are on Multics several commands that enhance your ability 
to type command lines efficiently. Two of these commands--abbrev and 
do--will be discussed in this section, and a third--exec com--will 
be discussed in Section 6. 


THE abbrev COMMAND 

The abbrev command enables you to create your own abbreviations 
for the elements you use incommand lines. For instance, if you found 
yourself repeatedly changing to another working directory with a 
command like the foilowing: 

! ecwd >udd>Training>Jones 


you could create an abbreviation for the pathname in order to avoid 


typing the lengthier form. The command line mignt then be as short 
as: 
! ewd J 


The letter "J" would be expanded to the character string it 
represents, inthis case ">udd>Training>Jones," and the command would 
then process with this pathname. 


You create abbreviations by invoking the abbrev command and then 
using a command-like invocation called an abbrev request line. To 
illustrate this first step, let's look at how you would create the 
abbreviation for ">dudd>Training>Jones." First, you invoke the 
abbrev command: 


! abbrev 
r 10:30 1.321 64 
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When invoked, the abbrev command returns no output: you simply get 
a ready message. But once invoked the abbrev command remains in 
effect until you cancelit. That is done by issuing an abbrev request 
line: 


! 6.q 


You may seldom find it necessary to issue this quit request. In 
fact, the abbrev procedure is so useful for minimizing typing at 
the terminal that users often include the abbrev command in their 
start_up.ec (see Section 6 in this manual) so that it is automatically 
invoked every time they log in. It is while the abbrev command is 
in effect that you can create, delete, and change abbreviations and 
use them in command lines. 


To create an abbreviation you must type a request line, 
which begins with a period (.) in the first non-blank space. To 
create an abbreviation that will be expanded no matter where it 
appears in a command line, you use the control request .a: 


r 10:30 1.321 64 


.a J >udd>Training>Jones 
r 10:31 0.011 65 


This request line places the abbreviation "J" in a special 
segment that is labelled with your Person id anda suffix of profile 
(e.g., Smith.profile). All of your abbreviations are stored in this 
segment, unless you specifically place some in other segments. You 
may, if you wish, have several separate segments for abbreviations. 
You would then specify with the abbrev request ".u" which group of 
abbreviations you'd like to use at that time. 


For the sake of simplicity, we'll assume here that all 
abbreviations are being placed in one segment named Smith.profile. 
So far, we've placed one abbreviation in this segment: 

J = Pudd>Training>Jones 


Now it can be used as an abbreviation anytime the abbrev command is 
in effect. 
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When it is invoked, the abbrev command sets up 4 special 
processor, called the abbrev processor, which works on each command 
line input to the system. This processor scans each line to detect 
and expand abbreviations and then passes the command line on to the 
normal command processor. In this process abbreviations are 
expanded only once, so you cannot nest abbreviations. 


To continue our illustration of the abbrev command feature on 
Multics, let's look at another type of abbreviation, one which is 
expanded only when it appears at the beginning of a line. Such a 
specific entry would be useful for the abbreviation of an entire 
command line or apart of the line that includes the command name. 
You might do this with the command line used above to change your 
working directory. In order to indicate that this abbreviation 
is to be expanded only when it appears at the beginning of a command 
line, type: 


! .ab C cwd >udd>Training>Jones 
Thus, to change to this particular directory, you would type 
only: 
1 ¢ 
You'll no doubt find need for a number of abbreviations, and to 
keep track of what they are, you'll occasionally want to read your 
profile segment. To do this while the abbrev command is in effect, 
you simply type: 
Dek 


You will then have a list like the following printed at your 
terminal: 


J >udd>Training>Jones 
S Smith 

N new.plans 

A add.plans 
O 

a 


old.plans 
re art customers 


| fs) c cwd >udd>Training>Jones | 
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The first six abbreviations shown here will be expanded if they 
appear anywhere in the command line. The lower case "b" to the left 
of the last abbreviation indicates that it will be expanded only when 
it appears at the beginning of a command line. 


Any abbreviation you create must be no more than eight characters 
long, and when you type it into a command line it must be bounded by 
break characters. And of course this latter condition makes it 
impossible for the abbreviation itself to contain any break 
characters. The characters that the abbrev processor treats as 
breaks are: 


formf eed 
vertical tab 
horizontal tab 
dollar sign ($) 
apostrophe (') 
grave accent (*) 
period (.) 

less than (<) 
greater than (>) 
braces ({}) 
parentheses (()) 
brackets ([]) 
newline 

space 

quotation mark (") 
semicolon (;) 
vertical bar (}) 


You will notice that the last seven characters in this list are 
those that were called reserved characters in Section 2. It is 
important to remember that while these characters are being used for 
the special purposes described earlier, they will also serve as break 
characters and thus possibly set off any abbreviations you are uSing. 
To be on the safe side, you should only use break and reserved 
characters when you have a specific need for them. That should 
prevent the expansion of characters by the abbrev processor when you 
do not mean them to be interpreted as abbreviations. 


In cases where you want to use characters that are defined 
as abbreviations for some other purpose, you can prevent the abbrev 
processor from expanding them by enclosing them in quotation marks. 
For instance, if you want to change working directories using a 
pathname that contains the entryname arc, you couldn't type: 


ewd >udd>Training>are 
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Because the string are is defined as an abbreviation in your 
profile segment, this pathname would be expanded to: 


>udd>Training>art customers 


The command would probably not be able to find a directory 
t expanded name and thus would return on error message: 


change wdir: Some directory in path specified 
does not exist. >udd>Training>art customers 


But this expansion could be suppressed by quotation marks: 
cwd Dudd>Training>"arc" 

It could also be suppressed by the request .<space>: 
- cwd Pudd>Training>arc 


By beginning the command line with a period and a space, you 
suppress expansion of the entire line, that is, no abbreviations 
contained in the line will be expanded. 


An effective way of avoiding unanticipated expansions is to 
use capital letters in abbreviations. Since Multics command 
language uses lower case letters, it is very unlikely that any 
String you use from command language will ever be confused with 
an abbreviation if your abbreviations use upper case letters. 
For instance, the entryname "arc" could not be confused with the 
abbreviation for "art customers" if the latter used a capital 


a 


A--"Arec.” 


Your existing abbreviations are also checked when you are 
adding abbreviations. If an abbreviation you are creating 
already exists, you will be asked whether or not you actually do 
wish to redefine it. You simply respond "yes" or "no". 


THE do COMMAND 


The do command enables you to substitute arguments in 
command line before executing the line. This is particularl 
useful for command lines that repeat a certain argument a numbe 
of times, such as those containing multiple commands. 
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Let's return to the segments containing plans that we used 
in previous illustrations. Suppose you are about to compose a 
new set of plans and want to discard your old plans. You decide 
to print a copy of the segment old.plans before deleting it, and 
you want to rename your most recent plans, currently in the 
segment named new.plans, to old.plans. To do this you could 


type: 
! print old.plans; delete old.plans; rename new.plans old.plans 


But with the do command you could avoid retyping the segment 
names by referring to them with special symbols included in the 
command line: 


' do "print &2; delete &2; rename &1 &2" new.plans old.plans 


Numbers preceded by an ampersand (&) refer to arguments 
listed after the quoted portion of the do command line. [In the 
example, "new-plans" is substituted for the &1 string at each 
point where &1 appears because "new.plans" is in the first 
position after the quoted portion of the command line. Likewise, 
"old.plans" substitutes for &2 because it is in the second 
position after the quoted string, separated from the first by a 
blank space. So, the above command line would expand to the 
following when the do command is executed: 


print old.plans; delete old.plans; rename new.plans old.plans 
This, of course, is the command we originally wanted to type. 

It is important to note here that if an argument is not 
supplied, nothing will be inserted in the places where the extra 
number and ampersand appears. The last argument would not be 
used to substitute for the extra places. For instance, if the 
command line shown above had an &3, it would be ignored: 

! do "print &2; delete *3; rename &1 &2" new.plans old.plans 
would be expanded to: 

print old.plans; delete ; rename new.plans old.plans 
After the print command executed, the delete command would return 
an error message because it has not been supplied with a 


pathname: 


Usage: delete paths -control args 
mo13208 0.186.535 


If, on the other hand, the command could execute regardless of 
the empty argument, it would not return an error message; it 
would go ahead and execute. 


5-6 CH25-00 


The do command is particularly useful in conjunction with 
the abbrev command. Earlier it was noted that abbreviations 
eannot be nested because the abbrev processor scans a command 
line only once. But the do command makes, in effect, two command 
lines out of one, so the abbrev processor does scan the command 
twice in this case, though of course it will not expand any 
abbreviations within the quoted command string during the first 
scan. You mignt, for example, use "P" as an abbreviation for 
"nlans" in the command line shown above and thus type: 


! do "print &2; delete &2; rename &1 &2" new.P 014.P 
The "P" would first be expanded: 
do "print &2; delete &2; rename &1 &2" new.plans old.plans 
and then substituted, producing the expansion shown earlier: 
print old.plans; delete old.plans; rename new.plans old.plans 
Often-used do command lines can even be added to your 
profile segment, a practice that will enable you to make very 
long command strings very easy to type. Take as an example one 
of the lines typed above and create an abbreviation for it, using 
the additional abbreviation "P" just suggested: 


' .ab PLAN do "print &2; delete &2; rename &1 &2" 


This will then reduce typing of the above string with new.plans 
and old.plans as the do command arguments to: 


' PLAN new.P old.P 
This expands first to: 
do "print &2; delete &2; rename &1 &2" new.plans old.plans 
and then the do command is executed, producing: 


print old.plans; delete old.plans; rename new.plans old.plans 


Because the do command uses quotation marks, it is necessary 
that we now understand further the convention of quoted strings 
in the Multics command language. We noted in Section 2 that 
quotation marks are used for passing characters exactly as they 
are typed: on the terminal, that is, suppressing the 
interpretation normally applied to them. As we have just seen 
above, they can be used in this manner to suppress the expansion 
of an abbreviation. But when one set of quotation marks is 
included within another set of quotation marks, as is quite 
likely with the do command, the inner quotes must be doubled. 
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For instance, if you apply the do command to the sort list 
command line used as an example in Section 2: 


sort list customers -sort "lastname firstname" 
it becomes: 


! do "sort list &1 -sort ""lastname firstname""" customers 


The inner quotation marks must be doubled because characters 
are interpreted individually from left to right. Thus the single 
quotation mark followed by another type of character (e.g., 
"sort list &1 -sort "lastname...) would be interpreted as the 
end of the quoted string that began with the first quotation 
mark. In that case, the quoted portion of the do command line 
would appear to be "sort list &1 -sort" and everything following 
it would be interpreted by the command processor as arguments for 
substitution. That, of course, is not the intention at all. 


But as it is in the above command line the doubled 
quotation marks are interpreted as single marks ("5 because they 
are enclosed within the outer quotation marks of the do command 
line. so, after the do command substitutes the argument, the 
command line is what we had in the original example: 


sort list customers -sort "lastname firstname" 


because the double quotation marks have been reduced to single 
marks by the do command. 
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SECTION 6 


exec com 


The exec_com command offers yet another means of abbreviating 
the typing involved in command invocation. With exec com you can 
place frequently used command sequences in segments that are then 
processed by the invocation of the exec comcommand. Plus it offers 
the feature of control statements, which permit more variety and 
control in the execution of command sequences. This procedure 
enables you to invoke a large number of commands with only one command 
and arguments. 


This feature is made even more flexible by the inclusion of 
arguments to the command that can be substituted for special strings 
in the exec com segment. By this means, and of course by including 
active functions as well, you can have the entire sequence of commands 
act on different input each time it is executed. And to deal with 
Variations in the execution process that different input might 
necessitate, you have the advantage of control statements. 


CREATING AN exec com SEGMENT 


An exec _com segment is created with a text editor and can make 
use of any of the Multics command conventions. The entryname you 
assign the segment must have the suffix ec (e.g. print.ec). 


To illustrate the creation and functioning of an exec com 
segment, we will create a short, simple segment comprised only of 
commands, that is, without any control statements. To change your 
working directory, print it, and list its segments and your access 
to them, you would type in the following lines with a text editor such 
as qedx (described in Part I): 
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qx 

a 

change wdir &1 
print wdir 
list 

\f 

w change.ec 


q 


Argument Substitution 


The ampersand character (&) and number used in the change wdir 
command line refers to an optional argument that is substituted when 
the exec _com command is invoked, just as is done with the do command. 
The ampersand character is also used in exec com to signify the start 
of a control statement; that will be discussed below. The particular 
values that are to be substituted are placed on the exec com command 
line, as in the following: 


! exec com change.ec >udd>Training>Jones 


When you are working with an exec com segment that calls for more 
than one argument to be substituted, you arrange the arguments in 
sequence, separated by blank spaces, after the pathname argument on 
the command line. Let's suppose you have a segment named action.ec 
which requires three arguments. The command line used to execute this 
segment would look like the following: 


! exec com action.ec flower tree shrub 


The three arguments--flower, tree, and shrub--would be substituted 
for ampersands and numbers in the following order: 


If the third argument were not supplied on the command line: 


! exec com action.ec flower tree 
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The space occupied by &3 would be left blank; the second argument 
"tree" would not be substituted in that space. If possible, the 
commands, active functions, and control statements will process 
without tne missing arguments, but if they cannot, an error message 
will be returned. Often, but not always, the error message will tell 
you which part of the exec com segment is not functioning. 


There are also some special substitutions that can be made in 
exec com segments. First of all, you can, if you wish, place the 
number of optional arguments supplied with a particular execution 
into the exec com lines. In the action.ec segment used above, any 
position containing the figure &n would receive the number 3 before 
the segment was executed. 


In another substitution you can place the entryname portion of 
the exec com's pathname, without the ec suffix, into the exec com 
segment. In the action.ec segment, any position containing the 


figure "&ec name" would receive the entryname action before the 
segment was executed. 


Lastly, you can place the directory name portion of the 
-exec com's pathname in the exec com segment by using &ec dir. 
Control Statements 

Control statements enable you to specify conditions for 
exec com segment. Currently there are twelve control statements: 

&label and &goto 

&attach, &detach, and &input line 

&command line, &ready, and &print 

&quit 

&if, &then, é&else 
As the list indicates, ampersands signify the start of a control 
Statement. Normally, control statements must start at the beginning 
of a line without any leading blanks. However, a &then can be on the 
same line as an &if, and other control statements can follow either 


&then or &else on the same line. For instance: 


a ie eee 
&then é&goto... 


6~3 CH25-00 


or 


&if... &then &goto... 


Some control statements set conditions for the ensuing input or 
execution of commands while others alter the normal sequence of 
command execution. An instance of the former is the &print statement. 
The execution of this statement causes the input which follows it 
to be printed at your terminal. 


To illustrate this type of control let's look at the execution 
of another exec com segment, called query.ec: 


change wdir [response "Working directory desired?" ] 
&print Your working directory is: 


print wdir 
&quit 


When you invoke tne exec com command on this segment: 
! exec com query.ec 


you will get the following output: 


change wdir [response "Working directory desired?"] 


Working directory desired? ! work 


Your working directory is: 
print wdir 
>udd>Pubs>Smi th>work 


You will notice that, in addition to the things this segment is 
designed to print, all of the segment's command lines are reprinted 
in the output. This can be prevented by another statement that 
establishes the conditions for the execution of subsequent commands, 
the &command line off control statement. As a matter of fact, this 
control is almost always used in exec com segments because the command 
lines seldom need to be reprinted. If we were to place &command line 
off at the beginning of query.ec, invocation would produce: — 
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Working directory desired? ! work 


Your working directory is: 
>udd>Pubs>Smithwork 


The &quit control statement is another of those that set 
conditions in that it marks the end of the exec com segment. It is 
good practice to include the &quit statement because later you may 
want to place several exec _coms together in one exec com segment. In 
those cases it will be necessary to mark clearly where one exec com 
ends and another begins. 


Then there are those control statements that alter the normal 
sequence of execution, the most obvious of which is the &if statement. 
This is used primarily with the &then and &else statements, and by 
using other control statements with these, you can further enhance 
the versatility you have to deal with varying situations. For 
instance, by including a &goto statement with a &then statement, you 
can skip over commands and go to a specific location when conditions 
specified by &if exist. 


To understand this type of control statement, let's look at 
an illustration which uses it. The following exec com segment is 
more intricate than our earlier examples because it combines command 
lines, a variety of control statements, and active functions, and it 


YaANnNI14 rand AYwrzar many 


requires argument subs titution. 


&command line off 

&if [compare &1 &2] 
&then print &1 

&else &goto process 
&quit 

&label process 

&if [compare &2 &3] 
&then print (&1 &2) 
&else print (&1 &2 &3) 
&quit 


REE en CRE eee 
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After turning off printing of its command lines, this exec com 
tests two segments for likeness with the compare command used as an 
active function. The two segments to be compared are supplied as 
arguments in the exec com command line. The compare active function 
returns the word "true" if the contents of both segments are the same 
and the word "false" if the contents are different. The control 
statement &if operates on the word that is returned. When the word 
"true" is returned, the &if statement shifts control to the &then 
control statement. When the word "false" is returned, the &if 
statement shifts control to the &else control statement. (The &if 
control statement is similar to the if command in that a then statement 
is required but an else statement is not.) 


The clause following &then, which must be on the same line, can 
include a command line, an optional argument, and the null 
statement. It can also include other control statements, except 
&label, &if, &then, and &else. These conditions are the same for the 
clause following é&else. 


Because the only action desired when the compare active 
function returns true is that one of the segments be printed, the 
clause following &then is simpiy the print command and a pathname 
argument. The &else condition, on the other hand, requires a further 
switching of control because it involves more than one command or 
control statement. Thus you use a &goto statement with a name, in 
this case "process," which automatically Switches the point of 
execution to the élabel statement with the matching name. Execution 
then resumes at the line immediately following é&label. 


Notice here that the line following é&else is &quit. This 
statement causes the current invocation of exec com, that is, all the 
subsequent command iines, to cease, whicn is exactly what you want 
when the condition is true andthe &then statement has been executed. 
If &quit were not included, execution would go to the second &if 
statement even when the original condition of the compare active 
function proved true. 


The second &if control statement in this sample exec com is 
designed to compare the segment supplied as the second optional 
argument with athird segment. If the compare active function returns 
"Crue" here, the &then clause, using the print command with iteration, 
has the first two segments printed at your terminal. When the 
comparison of the second and third segments returns "false," control 
shifts instead to the é&else control statement, which has all three 
segments printed. 
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start up.ec 


The start up.ec iS a special exec com segment that contains 
commands to be executed each time you log in, before anything is read 
from your terminal. In fact, you do not even need to invoke the 
exec com command for this segment; it is automatically invoked as part 
of the login procedure. The only things necessary for this 
automatic invocation are that the segment be named "start _up.ec" and 
that it reside in your home directory. 


This feature of the exec com is useful because users usually 
have certain operations that they want performed almost every time 
they log in. With a start up.ec they are saved the work of typing 
the required commands each time they enter the system. And if ever 
they wish to log in without executing these commands, they simply add 
the control argument -no start _up (-ns) to login. 


There are several commands that almost all users include in their 
start ups. These include: 


abbrev 
so that you can use your personal abbreviations during each 
terminal session 


print motd 
so that the system prints the message of the day when you 
haven't seen it before 


print mail 
so the system automatically prints your mail 


accept messages 
so you receive messages from other users online 


Then, of course, you probably would want to include the 
&command line off control statement at the beginning of your start up 
so that the segment's commands aren't printed at your terminal each 
time. 


There are also quite a few other commands that it is useful to 
invoke when you start up, and we will discuss some of the most 
important ones. To take advantage of your terminal's capabilities 
and make typing easier, you may want to include several set tty 
commands in your start _up on a conditional basis. This command 
provides many options and is invoked through the usage: 


set_ tty -modes OPTION1 ,OPTION2 ,OPTION3...,OPTIONn 
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Note that with the control argument -modes there is the unusual use 
of commas between its character strings, but there are no spaces. 


Ordinarily, several set tty commands are used conditionally in 
the start _up.ec so that you have the proper one actually invoked for 
the terminal you are using at a particular log in. Thus you would 
have a set of &if &then control statements for each type of terminal 
you might log in from. An example of the form is: 


&if [equal [user term type] TN300] 
&then set tty -modes 11118,crecho,1lfecho 


The user term type active function would return your particular 
terminal type and if it proved, by the active function equal, to be 
the TermiNet 300, then the important modes would be. set 
appropriately. 


In the -modes control argument above, the 11118 sets the line 
length at the TN300 to 118 columns or spaces. Without this 
specification your terminal would be set at 79 columns, the default 
setting. You could also use a number other than 118, depending on 
the limitations of a particular terminal. The crecho (carriage 
return echo) designation creates a situation in which a carriage 
return is provided each time a linefeed is typed. The lfecho 
(linefeed echo) designation provides for one linefeed each time you 
hit the carriage return key. Thus you can get a newline by typing 
either a carriage return or a linefeed. You must note, however, 
that the TermiNet 300 has an automatic linefeed switch which, when 
turned on, provides a linefeed automatically each time a carriage 
return is typed. So if you have that switch on and have the lfecho 
mode set, you will get a double linefeed. 


In order to gain an in-depth understanding of how start _up.ecs 
work and what they are used for, let's look at a somewhat complicated 
but quite realistic example of one. For the sake of explaining this 
example, the lines are numbered, though of course they couldn't be 
in the actual exec com. 
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&command line off 

&if [equal &2 interactive] &then &goto interactive 

&else send mail fuser name]j|user project| Absentee 
run started at [date time 

&goto all ~ 


&label interactive 


&’else print motd 

check info segs 

&if [have mail] &then string "You have mail." 
label new proc 


1 
2 
2 
4 
oer 
6. &if [equal &1 new proc] &then &goto new proc 
Ps 
8 
9 
0 
{ set tty -modes polite 


2. accept messages —print 

3. &if [equal [user term type] 1TN300] 

14. &then set tty -modes 11118,crecho, *lfecho 
15. &if [equal [user term “type | ASCII | 

16. &then set tty -modes crecho,lfecho 

17. &if [equal [user term type] VIP7801 ] 

18. &then set tty -modes crecho,lfecho 

19. &label all 

20. abbrev 

20a. “eQuEt 


This start_up.ec handles three conditions: logging in as an 
interactive user, which is what you ordinarily do, running an absentee 
job (discussed in Section 7) and creating a new process once you're 
already logged in. 


Line 2 checks to see if you are logging in as an interactive user, 
and if you are, sends control to line 5. The &2 argument is 
supplied automatically by the Multics system. When the start up.ec 
is invoked, the system places either the word "interactive" or the 
word "absentee" in the second optional argument position so one of 
those words is supplied in the &2 location; and here it is compared 
by the equal active function to the character string "interactive." 
If the active function returns false, because the invocation is for 
an absentee process, then execution begins at line 3, which sends a 
message to your mailbox telling you what date and time your absentee 
job began running. 


Line 4 then takes control and sends execution to the &label 
statement at line 19. The word "alli" is an appropriate &label name 
here because the lines following 19 are always executed when the 
start_up.ec is invoked, whether it be for interactive, absentee, or 
new process use. Those lines invoke the abbrev command and mark the 
end of the exec _ com segment. 
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If the check for interactive usage in line 2 had proved 
true, then you would be going through a different execution 
sequence before getting to lines 19 through 21. In such a case, 
control would, of course, skip over lines 3 and 4, go to line 5 
and start executing at line 6. 


Line 6 checks to see if you are creating a new process at 
this point in your interactive usage. A new process is created 
by the new _proc command or by an error that cancels your process. 
The new proc command cancels the current process and sets up a 
new one, using the control arguments given initially with the 
login command and the optional argument to the new _proc command 
itself. It's as though you logged out and immediately logged 
back in. The start _up.ec is again invoked automatically when a 
new process is started. The optional argument the system 
automatically gives in the first position with the invocation of 
the start up.ec is the character string login or new proc, 
depending on whether the invocation is coming from the initial 


log in or from the new proc command. SO im tine: 6, -&1 as 
substituted with one of those strings. If that string is 
new proc, then the equal active function returns true and 


execution is shifted to line 10, &label new proc. 


What the &goto control statement in line 6 vasses over are 
executions that would have been accomplished at the initial 
interactive log in and would not need repeating. Line 7 provides 
for a special handling of the message of the day. If you have no 
start up, the message is printed each time you log in; but when 
you once place a start up.ec in your home directory, the system 
assumes that you are taking action on your own to examine the 


message and thus stops printing it automatically. When 
incorporated in your start up, the print motd command keeps a 
copy of the last message of the day in a segment (called 


Person id.motd) in your home directory. Each time the command is 
invoked, usually during execution of your start up, it compares 
the current message with the saved one and prints the current one 
if it is changed from the saved copy. This way you don't have to 
see the message again and again when once is enough. 


The check info segs command in line. 8 is handy to have in 
the start_up because it prints a list of new or modified segments 
in the info segment library each time you log in. Much like the 
print motd command, it controls the listing by saving the current 
time in the user's profile so that when it is invoked again, it 
lists only info segments created or modified since the last 
invocation. 
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Line 9 checks your mail for you each time you log in 
interactively. By making the procedure conditional, as is done 
here, you can avoid the full printing of all your mail that you 
would get if you simply used the print mail command. This way, 
nothing is printed if you have no maii, and only "You have mail.” 
is printed if you do. When this latter is the case, you can then 
type the read_ mail command, which ailows you a great deal of 
control over printing the messages, after the start _up has 
finished executing. 


Provided you are not running an absentee process, your 
start _up executions wiil eventuaily get to line 10, whether from 
the &goto in line 6 or by executing through line 9. In either 
case, you will then pass on to lines 11 through 18 and then, of 
course, go on from 19 through 21, as in all start_up invocations. 
What happens here is first, in line 11, an unconditional setting 
of terminal modes to polite. Polite holds the printing of an 
output sent to your terminal (e.g., messages from other eens 
while you are typing input until the carriage returns to the left 
margin (i.e., when you type a newline). 


The accept messages command in line 12 allows your process 
to accept messages sent by the send message command and notices 
of the form "You have mail." sent by the send mail command. The 
-print control argument prints all messages sent to you by the 
send message command since the last time you were logged in and 
accepting messages. Messages and mail notices sent while you are 
logged in will then be printed out at your terminal, in this case 
when you next return the carriage to the left margin because you 


h +h T4+ A Mh 4 5 h +h h 1 
Nave tNS POilive Mogae on. LniS 1S necessary cecause tne cnecK ror 


mail, performed by line 9 in this start_up, does not check for 
messages sent by the send message command. 


If, while you are logged in, you defer messages with the 
defer messages command, all mail and messages sent to you are 
saved in your mailbox and can be read with the read mail or 
print messages commands. 7 


The only lines in this start up that we haven't discussed 
thus far are 13 through 18. These 6 lines contain three tests of 
terminal types, the procedure explained above using TN300 as an 
example. The three included in this start up are three that a 
user is very likely to encounter--TN300, ASCII, and VIP7801. But 
this start_up-ec would not prevent its user from logging in on 
another terminal. That terminal's default modes would simply be 
in force because no special modes are set by the start_up. Of 
course, the user could easily set modes for that terminal by 
uSing the set tty command while logged in. 
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The only convention used in these six lines that was not 
explained earlier is the “lfecho mode. The circumflex character 
(“5 acts as a negation, turning the particular mode off. This 
start up uses “lfecho because the TermiNet 300 has the automatic 
linefeed switch. 


Because it provides a way of storing oft-used command 
sequences, an abbreviated way of invoking them, and an internal 
means for controlling their execution, the exec _com command is 
one of the most powerful and useful features of the Multics 
system. And there are yet other aspects of the feature which can 
enhance your efficiency on the system. There are facilities for 
adding search paths to the exec _com search list, for answering 
questions generated by exec _com sequences, for combining a number 
of exec coms into one segment, and for handling conditions raised 
during execution of an exec _ com. In fact, there are ways that 
you can call one exec_com from another, or reenter the current 
one at an earlier point. These additional features are explained 
in full in the MPM Commands. 
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SECTION 7 


ADDITIONAL CONCEPTS 


The purpose of this section is to explain several concepts that 
are important in computer technology and have somewhat specialized 
applications in Multics. Some of these concepts you've probably 
encountered already and others you no doubt soon will. The 
presentation here will stay mainly on the conceptual level, that is, 
with no explanation of the procedure for implementing the processes. 
Any applications demonstrated will be used simply for the purpose of 
illustrating how a concept is applied to a procedure. 


ONLINE 


Being online means being logged in, entering information and 
using information already stored in the system. In Multics, online 
is an interactive process in that the system responds immediately to 
the user's input. This way you do not have to prepare an entire job 
beforehand to be run all at once; instead, th system will 
interact with you. 


A necessary additional aspect of interactive usage is 
time-sharing. Many users can interact with the system at the same 
time, even to the point of sharing the same segments simultaneously. 
For this reason, the system tells you each time you log in how many 
people are online and how many the system can accommodate at that time. 
And because the computer is shared this way, you may sometimes be 
preempted while working on the system. 
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ABSENTEE 


Absentee, on the other hand, is a process that can be run when 
the user is not logged in and interacting with the system. Instead, 
the user prepares an entire job beforehand and has it run at a 
specified time. It is analogous to batch processing on other 
systems. And an absentee job is not a time-sharing process in the 
sense that online processes are. The absentee job is placed in a 
waiting line pe OU eie ane Cun as Pack erQund te the normal interactive 

work on the system. 


The principal difference between an absentee process and an 
interactive one is that in an absentee process the I/O switches are 
attached to special absentee segments instead of to aterminal. One 
of these segments is the control segment containing commands and other 
input data which you create with atext editor. The other is an output 
segment which stores the results of the absentee job. The system adds 
a third component to the User id to distinguish absentee from 


interactive processes: absentee processes are labelled 
Person id.Project_ id.m while interactive processes use an "a" as the 
third component. These third components are called "instance 
tags." 


The details of executing absentee processes are given with the 
enter abs request command in the MPM Commands. 


Punched cards, when they are run on Multics, are processed in 
a batch similar to the manner in which absentee jobs are processed. 
The standard way of handling card decks in Multics is to place the 
deck in the card reader and read it into a system pool. You then log 
in on a terminal and transfer the card file from the system pool to 
your working directory using the copy cards command. The segment 
that this command creates is stored in the system can be used in 
interactive and absentee processes, just aS a segment created on a 
terminal would be used. 


STORAGE SYSTEM 


The segment is the basic unit of storage in the Multics 
system. It can vary in size, that is, in the amount of information 
it contains, and it may contain a collection of program instructions, 
text or other data, or it may be empty (a null segment). There is 
a limit to the amount of information that can be stored in a segment, 
but if any single collection of information is too long for one 
segment, it can be stored ina group of segments called amultisegment 
file. 
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Multics keeps track of segments by cataloging them in 
directories. The base directory, the one from which all otner 
directories and all segments emanate, is called the root 
directory. Figure 7-1 uses a representation of an inverted tree 
to demonstrate the relation of user Tom Smith and his project, 
Pubs, to the root. (Directories are represented by rectangles and 
segments by lozenges.) Notice the two directories immediately under 
the root (sss and udd). The sss (system library standard directory) 
is one of several library directories that catalog all the system 


commands and subroutines. The udd (user directory directory) 
directory is a catalog of project directories. It contains one 
directory entry for each project on the system. Likewise, each 


project directory normally contains one directory for each user on 
that project. 


The Multics system's virtual memory makes all segments in the 
storage system directly addressable. That means that in effect there 
is hardly any difference between main memory and secondary storage 
on Multics: information can be retrieved from storage virtually as 
fast as from memory. 


Since the physical movement of information between secondary 
storage and main memory is totally automatic, its structure is of no 
concern to the user when working on a process. A user does not have 
to be concerned with where and on what devices the segments 
reside. 
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Figure 7-1. Hierarchical Storage System 
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SEARCH RULES 


Whenever the user issues a command or references a program or 
other segment, the system must search through directories to find the 
specified command or program. This search is regulated by a list of 
search rules that specify a set of directories to be searched in a 
particular order. But the search rules that the system automatically 
follows may be changed or supplemented by the user. The 
set search rules command enables the usér to change the default 
search rules, and the add search rules and delete search rules 
commands enable the user to add or delete search directories. To 
check your current search rules, you can invoke the 
print search rules command. 


Adding another directory to be searched after the working 
directory is a convenient way for an entire project to share a group 
of special programs peculiar to the work of that project. After a 
user on the project adds this special directory to the search rules, 
any programs in that directory can be executed as easily as the system 
commands. This addition to the search rules means that each user on 
the project saves the time and cost of either copying each one of the 
programs or linking to each one. 


Also, by manipulating the search rules, the user can determine 
whether a system command or auser-written command with the same name 
is to be used. 


LINKING 


Multics allows a user to create a link to a segment anywhere in 
the storage system, as long as access to the directory of the linked 
segment is available. By creating a link, you can reference another 
segment as though it were in the directory containing the link. In 
short, you can use this particular segment without actually having 
to make a copy of it. 


Linking with the link command is not to be confused with dynamic 
linking. The latter is the Multics term for the mechanism in the 
system that provides a highly efficient means of referencing stored 
segments. It is enough, for our purposes here, to say that, with 
dynamic linking a segment must be searched for only once during a 
process. Whena segment is found by using the search rules, its place 
in the storage system is remembered so that another search does not 
have to be made the next time the segment is needed. 
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BOUND SEGMENTS 


A bound segment is a Single executable segment made up of two 
or more Separately compiled segments. Normally, you would bind 
program segments that you intend to execute together repeatedly. 
(See the bind command in MPM Commands.) Bound segments are easier 
for the user to process, and the system can run them much more 
efficiently than under the regular dynamic linking procedure. In 
fact, by binding segments you can not only save execution time, you 
can also save money through decreased computing time and storage 
space. 


ARCHIVE SEGMENTS 


Each segment in Multics is assigned space in increments of pages. 
Since this can result in quite a bit of blank space on the last page 
of segments, Multics provides the archive command to pack the contents 
of individual segments together into one archive segment. You can 
maintain control over these individual segments by invoking the 
archive command with different arguments, (see the archive command 
in MPM Commands). The advantage of archive segments is that they 
reduce the user's storage load and therefore cost. 


EDITOR MACRO 


In general computer terminology, macro refers to a group of 
executable statements. To that extent a macro is like an exec com 
segment on Multics. But in Multics the term macro is applied only 
to a sequence of text editor requests. This sequence of requests, 
called an editor macro, acts like a program or exec com. Placing it 
ina separate buffer preserves it for repeated application in the text 
editing environment. 


7-6 CH25-00 


APPENDIX A 


GLOSSARY 


The following list of terms is meant to add to the glossary 
provided in Part I of this New Users' Introduction (CH24). Most 
of the terms appear for the first time here, though several are 
repeated with expanded definitions. 


absolute pathname 
see pathname, absolute 


character string 
One group of characters unbroken by blanks; it 
Signifies one word to Multics. The characters may 
include alphabetic, numeric and some other characters 
(periods, hyphens, and underscores). 


command level 
The state the computer is in when it is ready to accept 
command lines. You are at command level when you log 
in, when a command completes execution or encounters an 
error, or when you stop command execution by issuing a 
quit signal. Command levels above level 1 are 
indicated by the ready message. 


command processor 
The program that interprets command lines and calls the 
appropriate programs, after processing parentheses and 
active functions. 


component (entryname) 


A part of an entryname. Entryname components are 
separated by a period (e.g., data base is the second 
component of the entryname random.data base.plans) 
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crash (FNP) 
an unplanned termination of service from the front-end 
network processor causing a disconnection of the 
process. The process can be saved and reconnected when 
the -save_on disconnect control argument has been used 
with the login command. 


crash (system) a 
An unplanned termination of system availability caused 
by problems in hardware and/or software, often 
Signalled by the message: MULTICS NOT IN OPERATION. 
Processes cannot be reconnected after a system crash. 


data base manager . 

A software system that integrates various computerized 
information units of an organization into a total 
system. With such a system, all users of data within 
an organization share common records of information and 
the information available at every level is drawn from 
the same source, providing mutually consistent levels 
of accuracy to all users. 


default 
The value or action that the system assumes when none 
has been specified by the user. 


entryname 
A name given to an item (segment or directory) 
contained in a directory. It may contain one or more 
components, separated by periods. All names given to 
entries within one directory are unique but need not be 
different from names used in other directories. 


1/0 switch 
A path in the I/O system through which information is 
sent. For example, the normal output switch 


(user output) is usually attached to the terminal, but 
it may be attached to a segment in storage by using the 
file output command. This would save the output ina 
segment rather than print it at the terminal. 


multiplexer 
A communications control device which permits sharing 
of facilities by connecting the central processing unit 
to a large number of communications channels that may 
all transfer data to or from the processor at one time. 


page (also known as record) 
A unit of storage in Multics. A page contains up to 
4096 characters. 


pathname 
A name of a segment or directory that specifies its 
location in the storage system. A pathname is either 
absolute or relative. 
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pathname, absolute 


A segment name preceded by the series of directory 
names that lead from the root to that segment: each 
level in the pathname is preceded by a ">". For 
example, the absolute pathname for a segment under a 
user's home directory is designated this way: 


>udd>Project id 


Vv 
hg 
4) 
ry 
tA 
e) 
rs 
ke 
Qu 
WV 
tA 
4) 
Oy 
E3 
(o>) 
rs 
ct 
Hb) 
o 
3 
MO 


All absolute pathnames begin with ">". 


pathname, relative 


The pathname that uniquely locates a segment relative 
to the working directory, by listing the pathnames of 
directories under which the segment resides. For 
example, the relative pathname for a segment that 
resides in a directory one level under the working 
directory is designated this way: 


lower _dir>segment name 


All relative pathnames begin WITHOUT ">". 


process 


The activities (programs, data entry, etc.) of an 
individual user that begin when the user logs in, 
including absentee log in, and continue until Logout or 
until another process is explicitly begun through use 
of the new_proc command. 


quota 


ring 


The maximum number of pages that can be used in a 
hierarchy of directories. Hach user is allotted a 
predetermined amount of quota; however, quota can be 
increased by a system administrator. 


structure 
The structure of access control on Multics which is 
implemented by special hardware. Operation is 


controlled in such a way that the computer's work is 
done in a number of mutually exclusive subsets. These 
subsets may be considered concentric rings of 
privilege, representing different levels of access 
rights. The innermost or hardcore ring is made up of 
those segments essential to all users. This innermost 
ring, designated as ring 0, represents the highest 
level of privilege. The work of most users is done in 
ring 4. Ring 7 is the ring of least privilege. 


search rules 


The rules that specify the order in which directories 
are searched to find a command, subroutine, or data 
iten. This is to be distinguished from addressing a 
segment by its pathname, which explicitly specifies the 
directory containing the segment. 
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subsystem 
A collection of programs that provide a_ special 
environment for some particular purpose, such as 


editing, calculation, or data management. It may 
perform its own command processing, file handling, and 
accounting. 

suffix 


The last component of an entryname, which often 
specifies the purpose of a segment (e.g., action.ec 
where ec specifies an exec _com segment). 
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APPENDIX B 


FUNCTIONAL BREAKDOWN OF SELECTED MULTICS COMMANDS 


Even aS anewuser you will fast find need for many more 
commands than have been discussed in Parts I and II of this New 
Users' Introduction to Multics. For that reason, this appendix 
provides you with a functional listing of Multics commands that 
are likely to become useful to you. 


The categories here are similar to those used in other 
Multics documentation (MPM Commands and Multics Pocket Guide). 
Ten of the seventeen categories normally used in the other 
manuals are used here along with a category which lists Multics' 
word processing commands. Some commands appear in more than one 
category just as they do in the functional groupings in other 
Multics manuals. 


Hach category includes a description of how the commands in 
that group function. A complete description of the individual 
commands, except those used in word processing, is contained in 
the alphabetical listing of commands in MPM Commands. The word 
processing commands are described individually in the Multics 
WORDPRO Reference Guide (Order No. AZ98). 


SELECTED COMMANDS LISTED BY FUNCTION 


LL OO te 6 | SD 


Access to the System 


Access commands connect the terminal to a process. The 
Oo command iS more correctly called a preaccess request 
use it is used before a process has been set up; it repeats 
the greeting message that is printed whenever a terminal is first 


connected to the system. 


© 


dial hello 
login logout 
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Storage System, Creating and Editing Segments 


The commands in this category enable the user to create, 
edit, and format segments. 


create edm 

emacs indent 
program interrupt gedx 
runoff — runoff abs 


Storage System, Segment Manipulation 


The commands in this category enable the user to compare and 
sort segments and adjust their sizes. Principally, they enable 
the user to manipulate a segment as a whole, copying it, 
truncating it, and moving it around in various ways in the 
storage system. 


archive compare 
copy delete 
link move 
sort_seg truncate 
unlink 


Storage System, Directory Manipulation 


The commands in this category enable the user to create, 
manipulate, and delete directories. 


copy dir create dir 
delete dir link ~ 
list move dir 
rename status 
unlink 


Storage System, Access Control 


This category contains the commands that set, check, copy, 
delete, and list access to segments and directories. 


check iacl copy_iacl 

copy iacl dir copy iacl seg 
delete acl delete iacl dir 
delete iacl_ seg list accessible 
list acl list not accessible 
list iacl dir list iacI seg 

set acl ~— set _iacl_ dir 


set_iacl_ seg 
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Storage System, Address Space Control 


Commands in this category 


add_search paths 

change __ default wdir 
delete search _paths 
get_ system_ search rules 
list ref names 

print_ default wdir 
print search paths 
print wdir 

set search rules 

where search paths 


Command Level Environment 


Basically, commands in this category 
and control the environment in which 
They enable the user to set the procedures by which other 
commands search for segments and directories, 
working directory, and to group commands 
a segment (even to abbreviate commands). 


abbrev 

add_search rules 

change default wdir 
delete search paths 

do = * 

general ready 

if ~ 

memo 

on 

print search paths 

print translator search rules 
program interrupt 7 
ready off 

release 

set_search rules 

stop run 


B=9 


this is 


enable the user to manipulate 
search paths and search rules and the working directory. 
category also contains the new_proc 
process with a new address space; 
out and logging back in. 


add_search rules 
change wdir 

delete search rules 
initiate 

new proc 

print _proc_ auth 
print. search rules 
set search paths 

where > 


add search paths 
answer i 

change wdir 

delete search rules 
exec com 

get system search rules 
line length ~ 
new proc 

print default wdir 
print search _ rules 
print wdir 

ready. 

ready on 

set search paths 
start 7 

where search paths 
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This 
command, which creates a new 
equivalent to logging 


are designed to set up 
other Multics commands are 


to manipulate the 
on a command line or in 


Communication Among Users 


The commands in this category give users facilities to send, 
receive, and store mail and short messages interactively with 
other users registered on Multics. 


accept messages . defer messages 
delete message immediate messages 
print auth names print mail 

print messages read_ mail 

send mail send message 

send message acknowledge send message express 
send message silent who 


Communication with the System 


With the commands in this category users can ask Multics 
what helpful information about the system operations is available 
on info segments and request help from particular info segments. 
Users can also find out how many people are using the system and 
who they are; in addition, users can request that the system's 
message of the day be printed at their terminal. 


check info_segs help 
how many users move abs request 
print motd who 


Control of Absentee Computations 


The commands in this category enter, move, and cancel 
requests to have work submitted by the user run by the system in 
the user's absence. 


cancel abs request cobol abs 

enter abs request fortran abs 
how_many users list_abs requests 
move abs request 3 pli_abs 

runoff abs who 
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T 


Wordprocessing 


Commands in this category are used to create, edit, and 
format text and process lists of information. 

add symbols add dict words 

change symbols compose 

copy list count dict words 

create list create wordlist 

delete dict words delete symbols 

emacs expand symbols 

find dict words find symbols 

list dict words list symbols 

locate words merge list 

option symbols print symbols path 

print wordlist process list — 

qedx retain symbols 

revise words show symbols 

sort list trim list 

trim wordlist use symbols 


? 
roy) 
C2 
Vy 
NO 
OI 
I 

oS) 
O 


APPENDIX C 


FUNCTIONAL BREAKDOWN OF SELECTED ACTIVE FUNCTIONS 


Like the commands, Multics active functions can be 
categorized by their operational use. The categories here are 
Similar to those used in other Multics documentation (MPM 
Commands and Multics Pocket Guide). Ten of the thirteen 
categories used in the other manuals are used here. And some 
active functions appear in more than one category just as they do 
in the functional groupings in other Multics manuals. 


Each category includes a description of what the active 
functions in that group do. A complete description of the 
individual active functions is contained in the alphabetical 
listing of active functions in MPM Commands. 


Arithmetic 


This group of active functions perform some arithmetic 
operation and returns the character string representation of the 
result. This group includes: 


ceil divide 
floor ma X 
min minus 
mod plus 
quotient times 
trunc 


C-1 CH25-00 


Character String 


This operational group returns the results of various 


operations on one or more character’ strings. This group 
includes: 

after copy characters 

index length 

low lowercase 

reverse underline 


upper _case 


Condition Handling 


The on active function is the only one in this group. It 
executes a command line and returns true if any of a particular 
set of conditions is Signalled during the execution. If none of 
the specific conditions are signalled, it returns false. 


Date and Time 


This group consists of active functions that return 
information about the date and time in various forms. This group 
includes: 


date date time 
day day name 
hour long date 
minute month 
month name time 

year 


Logical 


This group returns a character string value of either true 
or false. Active functions in this group are intended to be used 
with the &if control statement of the exec com command or with 
the if command. This group includes: 


and equal 
exists greater 
less nequal 
ngreater nless 


not or 
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Miscellaneous 


These active functions return miscellaneous information 
about the user's process or storage system entries This group 
includes: 


contents default 


Pathname Manipulation 


Active functions in this group construct a pathname based on 
the specified path argument and return all or part of this name. 
This group includes: 


directory entry 

equal name path 

strip strip entry 
suffix 


Question Asking 


This group returns a value based on the answer’ given by a 
user in response to a Specified question. This group includes: 


query response 


Storage System Names 


These active functions return either pathnames or entrynames 
of existing entries. This group includes: 


default wdir directory 
entries files 
home dir links 
segments 
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User/Process Information 


Active functions in this operational group return user 
information obtained from system data bases. This group includes: 


have mail last message 

last message time last message sender 
severity system 

user 
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INDEX 


abbrev command 5-1, 6-7, 6-9, 
Dag 
abbrev processor 


5-4 ’ 5-7 


absentee 6-9, 6-11, 7-2, A-3, 


B-4 


accept_messages command 6-7, 
6-9, 6-11, B-4 


compare 6 


contents 3-1, 3-3, 3-4, 
5-5, 3-6, 3-7 

date 6-5, 6-6 

date time 3-1, 3-2, 6-9 

equal 6-5, 6-6, 6-9, 6-10 

greater 6-5, 6-6 

have mail 6-9, 6-10 


home dir 4-8 

last_message sender 3-2 

plus 3-3, 3-4 

response 6-4 

string 6-5, 6-6 

times 3-3, 3-4 

underline 

user 3-2, 6-9 
definition 3-1 


add name command 4-5, B-2 


add_search rules command ‘7-5 


ampersand 5-6, 6-2, 6-3 
archive command 7-6, B-2 


archive segment 7-6 


bind command 7-6 


bound segment ‘7-6 


OE 


ecard reader 
7-2 


1-2, 1-4, 1-5, 


central processing unit 1-2, 
1-3, 1-4, 1-5, 1-6, A-2 


change wdir command 2-6, 5-1, 
5-4, 6-2, 6-4, B-3 

character string 2-6, 2-7, 
AnS,. d=9; “6x7, 629. 6-10 
het uC 


check info segs command 6-9, 
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command level 3-7, 4-9, A-1, 
B=5 


commands 
applied 
abbrev 
6-9 
accept messages 
add name 4-5 
change wdir 2-6, 5-1, 5-4 
check info_segs 6-9, 6-10 
delete 2-8, 5-6 
do 5-6, 5-7 
exec com 6-2, 6-4, 6-5, 
6-6, 6-9 
help 2-2, 2-5 
list 2-2, 2-3, 2-4, 4-2, 
4-5, 4-4 
new proc 6-10 
print 2-1, 2-6, 2-8, 5-6 
print messages 2-5 
print motd 6-9, 6-10 
print wdir 2-2, 2-5, 6-4 
program interrupt 4-9 
release 4-9 
rename 2-8, 4-5, 4-6, 4-7, 
5-6 
send mail 6-9 
send message 3-2 
set tty 6-8, 6-11 
sort list 2-7, 5-8 
start 4-9 
who 2-5 
definition 
system 2-2 
user—-written 


1-6 


5-1, 5-2; 5-3; Dm Ts 


6-9, 6-11 


21 
2-2 
compiler 
concatenation 4-8 
control statement 6-1, 6-2, 
6-3, 6-4, 6-5, 6-6, 6-7, 
6-10, C-2 


copy cards command ‘7-2 


CPU 
see central processing unit 
crash (FNP) A-2 


crash (system) A-2 


data base managers A-2 
default 2-2, 6-11, 7-5, A-2 


defer messages command 6-11, 
B-4 


delete command 2-8, 5-6, 5-7, 
B=2 


delete messages command B-4 


delete search rules command 


c=) 


do command 5-1, 5-5, 5-6, 5-7, 
6-2, B-3 


dynamic linking 7-5, 7-6 


editor macro 7-6 


enter abs request command ‘7-2, 
B-4 
equal name 


see equals convention 


equals convention 


percent sign 4-7 


4-1 9 4-5, 


exec com command 5-1, 6-1, 
B-3 
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file output command A-~2 line printer 1-3, 1-5 
FNP link command 7-5, B-2 
see front-end network 
processor linking 7-5 
FNP crash list command 2-2, 2-4, 4-2, 
see crash (FNP) 4-3, 4-4, 6-2, B-2 
front-end network processor login A-2 


1-4, 1-5, 1-6, A-2 
login command B-' 


hardware 1-2 
A-2, A-3 macro 
see editor macro 
help command 2-2, 2-5, B-4 
main memory 
see memory 


KH 


memory 1-2, 1-3 
I/O switch 7-2, A-2 multiplexer A-2 
if command 6-6, B-3 


input/output multiplexer 1-4, 


1-5 
newline 2-1, 2-6, 3-2, 6-8 
interactive 6-9, 7-1, 7-2, 
B-4 new proc command 6-10, A-3, 
B-2 
IOM 
see input/output multiplexer 
0 
iteration 2-8, 3-4 
online ‘7-1 
K 
is 


keypunch 1-2, 1-5 
page 1-2, 7-6, A-2 


peripherals 1-2 
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peripherals (cont) 

card reader i-2, 
[-2 

keypunch i-2, 1-5 

line printer 1-3, 

storage devices 1 

terminal i-2, 1-4 
6-8, 6-11, A- 


1 
=) 
Bat 


2 
print command 2-1, 2-6 
4-8, 5-6, 5-7, 6-6 
print mail command 6-7 


, 6-10, 
print messages command 2-5, 
6-11, B-4 


print motd command 6-7, 6-9, 
6-10, B-4 


print search rules command 
7-5 


print _wdir command 2-2, 2-5, 
6-2 3 6-4 5] B-%4 


Tew, ees hes 5 Beat. 
C-3 


process 
B-2, 


program interrupt command 4-9, 
B-2, B-3 


question mark 
see star convention 


QUIT 
see quit signal 


quit signal 4-8, 4-9, A-1 
quota A-3 


quoted strings 2-6, 4-8, 5-7 


ready message 1-2, 2-5, 2-6, 
4-8, 4-9, 5-1 


read_ mail command 6-11, B-4 
release command 4-9, B-%3 


rename command 2-8, 4-5, 4-6, 
4-7, 5-6, 5-7; B-2 


reserved characters 2-6, 3-6, 


4-8 ? 5-4 
ring structure A-3 


root directory 7-3, A-3 


search rules 


7-5 9 A-3 


secondary storage 
see storage system 
semicolon 


2-5, 2-6, 3-3 


send mail command 6-9, 6-11, 


B-4 

send message command 3-2, 
6-11, B-4 

set search rules command ‘7-5, 
B-3 

set_tty command 6-7, 6-8, 6-9, 
6-11 

software 1-2, 1-3, 1-6, A-2 


sort list command 2-7, 5-8, 
B-5 


star convention 
4—4 9 4~—5 
question mark 4-3 


2-4, 4a1, 4-2, 
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star name 
see star convention 


start command 4-9, B-3 


start up.ec 5-2, 6-7, 6-8, 
6-9, 6-10, 6-11 


storage system 1-5, 1-6, 7-2, 
7-4, 1=D% A-2, Ba? C= 
memory 1-2, 1-3, 7-3 
secondary storage 1-2, 1-3, 
1-3 
virtual memory 1-3, 7-3 


string active function 
as command 3-3, 3-4, 3-6, 
3—'7 ’ 6-9 


subsystem A-4 


system crash 
see crash (system) 


terminal 


20> GA 
627.628, 6-115 h=2, B=1 


time-sharing ‘7-1 


virtual memory 
see storage system 


who command 2-5, B-4 


i-5 
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